home *** CD-ROM | disk | FTP | other *** search
/ Aminet 32 / Aminet 32 (1999)(Schatztruhe)[!][Aug 1999].iso / Aminet / disk / moni / SCSISnoop.readme < prev   
Text File  |  1999-05-23  |  6KB  |  147 lines
  1. Short:    Snoops accesses to SCSI devices and others
  2. Author:   thor@math.tu-berlin.de (Thomas Richter)
  3. Uploader: thor@math.tu-berlin.de (Thomas Richter)
  4. Version:  1.01
  5. Type:     disk/moni
  6. Requires: Os 2.04
  7.  
  8. This tiny program snoops accesses to devices and prints the device commands
  9. as well as the answers of the device over the serial port. Its outputs can
  10. be made visible either by an external terminal, connected to the serial port
  11. at 9600 baud, 8 bit, 1 stop bit, or by the standard tool Sushi or its re-
  12. placement Sashimi.
  13.  
  14. SCSISnoop mainly useful to debug hardware drivers and filing systems; it
  15. is mainly intended to make SCSI device commands visible, even though it
  16. knows all standard scsi.device and the TD64 and NSD commands as well.
  17.  
  18. If a SCSI command is issued, SCSISnoop prints the full command name if
  19. available, even though it does not yet attempt to make its parameters
  20. readable. 
  21. _____________________________________________________________________________
  22.  
  23. Changes made for 1.01:
  24.  
  25. - The maximal size of the dumped data is now adjustable by the MAXDUMP
  26.   option.
  27. - SCSISnoop prints now an ellipsis "..." in case the data is longer than
  28.   the size selected by MAXDUMP and SCSISnoop cut the data size down.
  29. _____________________________________________________________________________
  30.  
  31. Synopsis:
  32.  
  33. SCSISnoop    SCSIONLY/S,FILTERRW/S,DEVICE/A,UNIT/A/N,FLAGS/N,MAXDUMP/K/N
  34.  
  35.  
  36. SCSIONLY    If this switch is given, SCSISnoop prints only HD_SCSICMDs
  37.         and the device replies; standard exec commands are not
  38.         snooped.
  39.  
  40. FILTERRW    If set, SCSISnoop filters the SCSI READ(6/10), WRITE(6/10)
  41.         WRITE_AND_VERIFY(6/10) commands out, they are not snooped.
  42.  
  43. DEVICE        This specifies the name of the exec device to be snooped,
  44.         e.g. "gvpscsi.device","scsi.device","cybscsi.device".
  45.  
  46. UNIT        The unit number to snoop. This is in most cases the SCSI
  47.         ID of the device to be snooped.
  48.  
  49. FLAGS        A flags value for opening the device. This defaults to zero
  50.         and should be left alone in most cases.
  51.  
  52. MAXDUMP        The maximal number of bytes SCSISnoop dumps over the line,
  53.         defaults to 64.
  54.  
  55. _____________________________________________________________________________
  56.  
  57.                          The THOR-Software Licence (v2, 24th June 1998)
  58.  
  59.  
  60. This License applies to the computer programs known as "SCSISnoop". 
  61. The "Program", below, refers to such program. The "Archive" refers to 
  62. the package of distribution, as prepared by the author of the Program, 
  63. Thomas Richter. Each licensee is addressed as "you".
  64.  
  65.  
  66.  
  67. The Program and the data in the archive are freely distributable
  68. under the restrictions stated below, but are also Copyright (c)
  69. Thomas Richter.
  70.  
  71. Distribution of the Program, the Archive and the data in the Archive by a
  72. commercial organization without written permission from the author to any
  73. third party is prohibited if any payment is made in connection with such
  74. distribution, whether directly (as in payment for a copy of the Program) or
  75. indirectly (as in payment for some service related to the Program, or
  76. payment for some product or service that includes a copy of the Program
  77. "without charge"; these are only examples, and not an exhaustive enumeration
  78. of prohibited activities).
  79.  
  80.  
  81. However, the following methods of distribution
  82. involving payment shall not in and of themselves be a violation of this
  83. restriction:
  84.  
  85.  
  86. (i) Posting the Program on a public access information storage and
  87. retrieval service for which a fee is received for retrieving information
  88. (such as an on-line service), provided that the fee is not
  89. content-dependent (i.e., the fee would be the same for retrieving the same
  90. volume of information consisting of random data).
  91.  
  92.  
  93. (ii) Distributing the Program on a CD-ROM, provided that
  94.  
  95. a) the Archive is reproduced entirely and verbatim on such CD-ROM, including
  96. especially this licence agreement;
  97.  
  98. b) the CD-ROM is made available to the public for a nominal fee only,
  99.  
  100. c) a copy of the CD is made available to the author for free except for
  101. shipment costs, and
  102.  
  103. d) provided further that all information on such CD-ROM is redistributable
  104. for non-commercial purposes without charge.
  105.  
  106.  
  107. Redistribution of a modified version of the Archive, the Program or the
  108. contents of the Archive is prohibited in any way, by any organization,
  109. regardless whether commercial or non-commercial. Everything must be kept
  110. together, in original and unmodified form.
  111.  
  112.  
  113.  
  114.  
  115. Limitations.
  116.  
  117.  
  118. THE PROGRAM IS PROVIDED TO YOU "AS IS", WITHOUT WARRANTY. THERE IS NO
  119. WARRANTY FOR THE PROGRAM, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT
  120. LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
  121. PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS. THE ENTIRE
  122. RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD
  123. THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY
  124. SERVICING, REPAIR OR CORRECTION.
  125.  
  126.  
  127. IF YOU DO NOT ACCEPT THIS LICENCE, YOU MUST DELETE THE PROGRAM, THE ARCHIVE
  128. AND ALL DATA OF THIS ARCHIVE FROM YOUR STORAGE SYSTEM. YOU ACCEPT THIS
  129. LICENCE BY USING OR REDISTRIBUTING THE PROGRAM.
  130.  
  131.  
  132.                                                         Thomas Richter
  133. _____________________________________________________________________________
  134.  
  135. So long,
  136.     Thomas Richter (May 1999)
  137.  
  138.  
  139. ============================= Archive contents =============================
  140.  
  141. Original  Packed Ratio    Date     Time    Name
  142. -------- ------- ----- --------- --------  -------------
  143.     6536    3608 44.7% 09-May-99 11:59:40 +SCSISnoop
  144.     5223    2328 55.4% 09-May-99 12:03:04 +SCSISnoop.readme
  145. -------- ------- ----- --------- --------
  146.    11759    5936 49.5% 10-May-99 23:53:46   2 files
  147.